From 25473724b087ccdc077289eba79904a9c9ed7545 Mon Sep 17 00:00:00 2001 From: Robert Lipe Date: Mon, 6 Jul 2020 12:15:58 -0500 Subject: [PATCH] Replace xxx with nnn for clarity --- xmldoc/chapters/use.xml | 10 +-- .../filters/options/transform-rptdigits.xml | 2 +- xmldoc/filters/options/transform-rptname.xml | 2 +- xmldoc/formats/lowranceusr.xml | 4 +- .../formats/options/transform-rptdigits.xml | 2 +- xmldoc/formats/options/transform-rptname.xml | 2 +- xmldoc/formats/xmapwpt.xml | 80 ------------------- 7 files changed, 11 insertions(+), 91 deletions(-) delete mode 100644 xmldoc/formats/xmapwpt.xml diff --git a/xmldoc/chapters/use.xml b/xmldoc/chapters/use.xml index 8dea30b79..555ed8638 100644 --- a/xmldoc/chapters/use.xml +++ b/xmldoc/chapters/use.xml @@ -358,19 +358,19 @@ merged data to multiple destinations. Read realtime positioning from Garmin USB, write to Keyhole Markup - gpsbabel -T -i garmin -f usb: -o kml -F xxx.kml + gpsbabel -T -i garmin -f usb: -o kml -F example.kml - Will read the USB-connected Garmin and rewrite 'xxx.kml' atomically, + Will read the USB-connected Garmin and rewrite 'example.kml' atomically, suitable for a self-refreshing network link in Google Earth. Read realtime positioning from Wintec WBT-201 via Bluetooth on Mac, write to Keyhole Markup - gpsbabel -T -i nmea -f /dev/cu.G-Rays2-SPPslave-1 -o kml -F xxx.kml + gpsbabel -T -i nmea -f /dev/cu.G-Rays2-SPPslave-1 -o kml -F example.kml Will read the Wintec WBT-201 via Bluetooth, using the name that - the Mac assigned it, and rewrite 'xxx.kml' atomically, + the Mac assigned it, and rewrite 'example.kml' atomically, suitable for a self-refreshing network link in Google Earth. @@ -459,4 +459,4 @@ merged data to multiple destinations. Print version number. - \ No newline at end of file + diff --git a/xmldoc/filters/options/transform-rptdigits.xml b/xmldoc/filters/options/transform-rptdigits.xml index e6feb7571..b6333fc46 100644 --- a/xmldoc/filters/options/transform-rptdigits.xml +++ b/xmldoc/filters/options/transform-rptdigits.xml @@ -2,7 +2,7 @@ This option lets you configure how many digits GPSBabel uses for numbering generated route point names. -When GPSBabel creates route points during the transformation process these points are sequentially numbered and named "RPTxxx" where xxx represent the number. By default GPSBabel uses 3 digits for these numbers. Rationale: This way a large number of route points can be uniquely named while the generated names are limited to 6 characters. This limitation is imposed by specific GPS-devices. +When GPSBabel creates route points during the transformation process these points are sequentially numbered and named "RPTnnn" where nnn represent the number. By default GPSBabel uses 3 digits for these numbers. Rationale: This way a large number of route points can be uniquely named while the generated names are limited to 6 characters. This limitation is imposed by specific GPS-devices. Using this option GPSBabel can be configured to use less or more digits for the generated names. This option is best used in conjunction with the rptname option. diff --git a/xmldoc/filters/options/transform-rptname.xml b/xmldoc/filters/options/transform-rptname.xml index 39a1c2fce..29e66831b 100644 --- a/xmldoc/filters/options/transform-rptname.xml +++ b/xmldoc/filters/options/transform-rptname.xml @@ -2,7 +2,7 @@ With this option you can decide to let GPSBabel name generated route points according to their source track name. -GPSBabel creates route points during the transformation process named "RPTxxx" where xxx is a numeric part. +GPSBabel creates route points during the transformation process named "RPTnnn" where nnn is a numeric part. Using this option GPSBabel can be configured to replace the "RPT" part of the generated names by the name of the source track during the transformation process. This is especially usefull if several differently named tracks are contained in the source file which should each be transformed into routes. diff --git a/xmldoc/formats/lowranceusr.xml b/xmldoc/formats/lowranceusr.xml index b616c6180..832707abe 100644 --- a/xmldoc/formats/lowranceusr.xml +++ b/xmldoc/formats/lowranceusr.xml @@ -62,8 +62,8 @@ device capabilities. Some early systems also supported entities called event marker icons. Event icon markers are represented by symbol, latitude and longitude data only. By default, event marker icons are converted by GPSBabel to waypoints on read with their name being generated -in the format "Event Marker XXX" -where XXX is replaced by the squence number of the Event Marker ICON found in the input data. +in the format "Event Marker NNN" +where NNN is replaced by the squence number of the Event Marker ICON found in the input data. You have the option to ignore Event Icon Markers effectively removing them from the output data using the input option ignoreicons. On output, you can use the write option writeasicons to create event marker icons diff --git a/xmldoc/formats/options/transform-rptdigits.xml b/xmldoc/formats/options/transform-rptdigits.xml index b810e9a4f..690361f86 100644 --- a/xmldoc/formats/options/transform-rptdigits.xml +++ b/xmldoc/formats/options/transform-rptdigits.xml @@ -2,7 +2,7 @@ This option lets you configure how many digits GPSBabel uses for numbering generated route point names. -When GPSBabel creates route points during the transformation process these points are sequentially numbered and named "RPTxxx" where xxx represent the number. By default GPSBabel uses 3 digits for these numbers. Rationale: This way a large number of route points can be uniquely named while the generated names are limited to 6 characters. This limitation is imposed by specific GPS devices. +When GPSBabel creates route points during the transformation process these points are sequentially numbered and named "RPTnnn" where nnn represent the number. By default GPSBabel uses 3 digits for these numbers. Rationale: This way a large number of route points can be uniquely named while the generated names are limited to 6 characters. This limitation is imposed by specific GPS devices. Using this option GPSBabel can be configured to use less or more digits for the generated names. This option is best used in conjunction with the rptname option. diff --git a/xmldoc/formats/options/transform-rptname.xml b/xmldoc/formats/options/transform-rptname.xml index 18fb49c17..a471bb9ff 100644 --- a/xmldoc/formats/options/transform-rptname.xml +++ b/xmldoc/formats/options/transform-rptname.xml @@ -2,7 +2,7 @@ With this option you can decide to let GPSBabel name generated route points according to their source track name. -GPSBabel creates route points during the transformation process named "RPTxxx" where xxx is a numeric part. +GPSBabel creates route points during the transformation process named "RPTnnn" where nnn is a numeric part. Using this option GPSBabel can be configured to replace the "RPT" part of the generated names by the name of the source track during the transformation process. This is especially useful if several differently named tracks are contained in the source file which should each be transformed into routes. diff --git a/xmldoc/formats/xmapwpt.xml b/xmldoc/formats/xmapwpt.xml deleted file mode 100644 index ab78e6582..000000000 --- a/xmldoc/formats/xmapwpt.xml +++ /dev/null @@ -1,80 +0,0 @@ - -DeLorme XMapHandHeld Street Atlas USA is another of the -billion CSV variants. -This is the format used by XmapHH SA USA on (at least) PocketPC O/S. - - -This XMap is not the same as the simpler -XMap format, which is used with Topo USA 4.0 -and XMapHH for Palm. - - -DeLorme XMap Handheld .WPT for PocketPC is a bit of a kludge. This -chapter covers XMap Handheld Street Atlas USA edition. - - -XMap on the PocketPC stores its waypoints in individual .wpt files. -For example, waypoints generated by XMap on the PocketPC are stored -by default in the "My Documents" folder using the sequential names -"XMap1.wpt", "XMap2.wpt", ad nauseam. Needless to say, this is not very -efficient. - - -As writing multiple waypoint files is outside of the scope of GPSBabel, -GPSBabel chooses to write one big file, one waypoint per line. -Extracting lines from this file is left as an exercise for the end user. -A simple Perl script to handle this conversion is included at the end -of this chapter. - - -It should also be noted that reading multiple files -is indeed possible, but if you have more than a few points, it can be a task. -For example: - -gpsbabel -i xmapwpt -f Xmap1.wpt -f Xmap2.wpt -o mapsend -F mapsend.wpt - -will read the two Xmap .wpt files and write one mapsend file. This -is fine for a small handful of points, but could be quite cumbersome -for folks like me who have 100+ waypoints loaded into XMap. For *nix -folks, something as simple as: - -cat *.wpt > /tmp/foo.wpt -gpsbabel -i xmapwpt -f foo.wpt -o mapsend -F mapsend.wpt - -will do the trick just fine. - - -#!/full/path/to/perl -$INPUTFILE = @ARGV[0]; -$TARGETDIR = @ARGV[1]; -$FILENAME = @ARGV[2]; - -if (! $FILENAME) { - print "Usage: xmap_split.pl " . - "INPUT_FILE OUTPUT_DIRECTORY FILENAME_BASE\n"; - print " (i.e. xmapl_split.pl points.wpt /tmp/points GPSB)\n"; - print " (created GPSB0001-GPSBXXXX " . - " in /tmp/points/ from points.wpt)\n"; - exit; -} - -open (INFILE, $INPUTFILE) || die "Cannot open $INPUTFILE for read!\n"; - -while (<INFILE>) { - $lc++; - $filename = sprintf("%s/Gpsb%04d.wpt", $TARGETDIR, $lc); - - open (OUTFILE, ">$filename") || - die "Cannot open $filename for write!\n"; - - print OUTFILE $_; - - close(OUTFILE); -} - -exit; - - - -Contributed to GPSBabel by Alex Mottram. - -- 2.30.2